home *** CD-ROM | disk | FTP | other *** search
/ Scene Storm / Scene Storm - Volume 1.iso / coding / tools / asm1.29 / asm1_manual < prev    next >
Encoding:
Text File  |  1980-01-04  |  11.6 KB  |  463 lines

  1.  
  2.             ^^^^^^^^^^^^^^^^^^^^^^^
  3.              ASMONE V1.06 by T.F.A.
  4.  
  5. Short manual !!
  6.  
  7. In this manual three different parenthese are used. This is what they stand for:
  8.  
  9. (*)     The * given is a KEY that MUST BE pressed.
  10. {*}     The * given is a parameter that MAY BE specified but is not needed.
  11. [*]     The * given is a parameter that MUST BE specified or the command will
  12.         not execute !!!
  13.  
  14. Command line commands :
  15.  
  16. A    =       Assemble source.
  17.  
  18. Syntax:            A
  19. Discription:    Assembles the source intro an executeble / binairy file in
  20.                 memory.
  21.  
  22.  
  23. AD    =    Assemble source and start debugger.
  24.  
  25. Syntax:         AD
  26. Discription:    Start with the same as command A then starts the debugger. The
  27.                 debugger is a powerfull tool while using Asmone V1.06 and will
  28.         enable u to see the source as well as the op-code. Debugger
  29.         commands are listed below.
  30.  
  31.  
  32. AO    =    Assemble source with optimize.
  33.  
  34. Syntax:         AO
  35. Discription:    This will check all the BRA, BSR etc, etc commands and add the
  36.                 .S, When assembling all not allowed short branches will
  37.                 be returned to .W sizes.
  38.  
  39.  
  40. B    =    Jump to bottom of source file
  41.  
  42. Syntax:         B
  43. Discription:    This will set the source editor pointer to the last line.
  44.  
  45.  
  46. C    =    Copy memory.
  47.  
  48. Syntax:         C
  49.                 Start>          [Source start]
  50.                 End>            [Source end]
  51.                 Dest>           [Destination start]
  52. Discription:    This will copy memory from the [source start] until the
  53.                 [source end] to the [destination start]
  54.  
  55.  
  56. CC      =       Calculate Checksum of bootblock
  57.  
  58. Syntax:         CC
  59. Discription:    This will read the bootblock of DF0: and recalculate the
  60.                 checksum. When done it will overwrite the bootblock with the
  61.                 correct value's. MAKE SURE DF0: IS WRITE ENABLED !!
  62.  
  63.  
  64. CD      =       Create directory
  65.  
  66. Syntax:         CD              {drive:subdirectory/}[directoryname]
  67. Discription:    This will create (if possible) a directory in {drive:subdirectory}
  68.                 with the name [directoryname]
  69.  
  70.  
  71. CS      =       Create sinus in memory
  72.  
  73. Syntax:         CS
  74.                 Dest>        [start adress]
  75.                 Beg>        [start of sinus]
  76.                 End>        [end of sinus]
  77.         Amount>        [number of steps]
  78.                 Amplitude>    [heigth of sinus]
  79.         Yoffset>    [start of Y]
  80.         Size>        [(B)ytes, (W)ords or (L)ongwords]
  81.         Multiplier>    [afterwards multiplier]
  82.         Hcorrection>    [half correction (Y)es or (N)o]
  83.         Rcorrection>    [round correction (Y)es or (N)o]
  84. Discription:    This will create a sinus in memory. It will start at memory
  85.         adress [Dest], start the sinus wave from [Beg] to [End] with a
  86.         top of [Amplitude] using a [Roundcorrection or intcorrection]
  87.         and will be making steps of [1 or .5] and multimply it with the
  88.         [multiplier]. It will create a blok of [Amount] with the
  89.         size [Size].
  90.         P.S. It will first add the Yoffset and afterwards multiply it !!!
  91.  
  92. CCS    =    Create sinus in source
  93. Syntax:         CSS
  94.                 Beg>        [start of sinus]
  95.                 End>        [end of sinus]
  96.         Amount>        [number of steps]
  97.                 Amplitude>    [heigth of sinus]
  98.         Yoffset>    [start of Y]
  99.         Size>        [(B)ytes, (W)ords or (L)ongwords]
  100.         Multiplier>    [afterwards multiplier]
  101.         Hcorrection>    [half correction (Y)es or (N)o]
  102.         Rcorrection>    [round correction (Y)es or (N)o]
  103. Discription:    This will create a sinus in yout source. It will start at the
  104.         current source line. Start the sinus wave from [Beg] to [End]
  105.         with a top of [Amplitude] using a [Roundcorrection or
  106.         intcorrection] and will be making steps of [1 or .5] and
  107.         multimply it with the [multiplier]. It will create a blok of
  108.         [Amount] with the size [Size].
  109.         P.S. It will first add the Yoffset and afterwards multiply it !!!
  110.  
  111.  
  112. D    =    Disassemble memory
  113.  
  114. Syntax:        D {adress}
  115. Discription:    This willstart the disassembler. If no adress is given it will
  116.         start the disassembly from the current PC.
  117.  
  118.  
  119. E    =    Load externals
  120.  
  121. Syntax:        E
  122. Discription:    This will load all of the external files specified in your
  123.         source.
  124.  
  125.  
  126. F    =    Fill memory
  127.  
  128. Syntax:        F
  129.         Beg>        [Start adress]
  130.         End>            [End adress]
  131.         Data>        [Data to fill with]
  132. Discription:    This will fill your memory from [Beg] to [End] with [Data]
  133.  
  134.  
  135. G    =    Go
  136.  
  137. Syntax:        G {adress}
  138.         Breakpoint>    [Set breakpoint to adress]
  139. Discription:    This will start running at {adress} untill PC reaches the first
  140.         breakpoint. If no adress is given it will start at the current
  141.         PC which will be set to your programm when assembled with no
  142.         errors. If no breakpoint is given it will run untill the RTS/RTE
  143.         is given past the stack !!
  144.  
  145.  
  146. H    =    Hexadecimal memory dump
  147.  
  148. Syntax:        H {adress}
  149. Discription:    This will give a hexadecimal memory dump starting at {adress}.
  150.         If no adress is given it will start it's dump from the current
  151.         PC.
  152.  
  153.  
  154. I    =    Insert    file in source
  155.  
  156. Syntax:        I {drive:directory/filename}
  157. Discription:    This will start inserting the file {drive:directory/filename} in
  158.         your source from the current source line.
  159.  
  160.  
  161. ID    =    Insert disassmbly in source
  162.  
  163. Syntax:        ID
  164.         Beg>            [Start adress]
  165.         End>                [End adress]
  166.         Remove unused label>    [(Y)es / (N)o]
  167. Discription:    This will start inserting a piece of disassembly in your source
  168.         from the current source line, and will add a label to every
  169.         line. When ready the unused label can be removed.
  170.  
  171.  
  172. IH    =    Insert hexadecimal dump in source
  173.  
  174. Syntax:        IH.{(B)yte,(W)ord or (L)ongword}
  175.         Beg>
  176.         End>
  177. Discription:    This will start inserting a piece of hexadecimal memory dump in
  178.         your source from the current source line. If no size is
  179.         specified bytes will be the default.
  180.  
  181.  
  182. IN    =    Insert ascii dump in source
  183.  
  184. Syntax:        ID
  185.         Beg>            [Start adress]
  186.         End>                [End adress]
  187. Discription:    This will start inserting a piece of ascii dump in your source
  188.         from the current source line.
  189.  
  190.  
  191. J    =    Jump
  192.  
  193. Syntax:        J {adress}
  194. Discription:    This will start running at {adress} untill PC reaches a RTE
  195.         If no adress is given it will start at the current PC which
  196.         will be set to your programm when assembled with no errors.
  197.  
  198.  
  199. K    =    Step
  200.  
  201. Syntax:        K
  202. Discription:    This will take 1 step in your programm.
  203.  
  204.  
  205. L    =    Locate
  206.  
  207. Syntax:        L {string}
  208. Discription:    This will search for a string in your source. If no string is
  209.         given it will search for the last searched string.
  210.  
  211. M    =    Edit memory direct
  212.  
  213. Syntax:        M {adress}
  214. Discription:    This will enable u to edit memory starting at {adress}. If no
  215.         adress is given it will start editing at the last known
  216.         edit / dump adress.
  217.  
  218.  
  219. N    =    Edit memory as ascii
  220.  
  221. Syntax:        N {adress}
  222. Discription:    This will enable u to edit memory in ascii mode starting
  223.         at {adress}. If no adress is given it will start editing
  224.         at the last known edit / dump adress.
  225.  
  226. O    =    Old source back
  227.  
  228. Syntax:        O
  229. Discription:    This will recover your source after a ZS command. (if possible)
  230.  
  231.  
  232. P    =    Print line
  233.  
  234. Syntax:        P {number}
  235. Discription:    This will print a number of line starting at the current
  236.         source line.
  237.  
  238.  
  239. Q    =    Compare memory
  240.  
  241. Syntax:        Q
  242.         Beg>        [start adress]
  243.         End>        [end adress]
  244.         Dest>        [start dest adress]
  245. Discription:    This will compare memory starting at [start adress] thru [end
  246.         adress] with [start dest adress]
  247.  
  248.  
  249. R    =    Read source
  250.  
  251. Syntax:        R {filename}
  252. Discription:    This will read a new source file.
  253.  
  254.  
  255. RB      =       Read binairy
  256.  
  257. Syntax:        RB {filename}
  258.         Beg>        [Beg adress]
  259. Discription:    This will read a binairy image file at [Beg adress]
  260.  
  261.  
  262. RO      =       Read object
  263.  
  264. Syntax:        RO {filename}
  265. Discription:    This will read an executable file.
  266.  
  267.  
  268. RS    =    Read sector(s)
  269.  
  270. Syntax:         RS         {number}
  271.           RAM PTR>    [adress]
  272.         DISK PTR>       [disk offset]
  273.         LENGTH>         [number of sectors]
  274. Discription:    This will read sectors from disk {number} into [adress] starting
  275.         at [disk offset] and read [number of tracks]
  276.  
  277.  
  278. RT    =    Read tracks
  279.  
  280. Syntax:         RT        {number}
  281.           RAM PTR>    [adress]
  282.         DISK PTR>       [disk offset]
  283.         LENGTH>         [number of tracks]
  284. Discription:    This will read tracks from disk {number} into [adress] starting
  285.         at [disk offset] and read [number of tracks]
  286.         P.S. These are TRACKS and not CYLINDERS !!!!!!!
  287.  
  288. S    =    Search in memory
  289.  
  290. Syntax:        S
  291.         Beg>        [Beg adress]
  292.         End>        [End adress]
  293.         Data>        [data to search for]
  294. Discription:    This will search for [Data] from [Beg] to [End]
  295.  
  296.  
  297. T    =    Top of source
  298.  
  299. Syntax:        T {line number}
  300. Discription:    This will jump to the line number specified. If no line number
  301.         is specified this will jump to the top of your source.
  302.  
  303.  
  304. U    =    Update current source
  305.  
  306. Syntax:        U
  307. Discription:    This will update your source without the 'file allready exist'
  308.         message. It will write the source in the current directory.
  309.  
  310.  
  311. V    =    Directory
  312.  
  313. Syntax:        V         {directory}
  314. Discription:    This will change from current directory and show it. If a space
  315.         is left between the V and the {directory} it will only change of
  316.         current directory.
  317.  
  318.  
  319. W       =    Write source
  320.  
  321. Syntax:        W         {filename}
  322. Discription:    This will write your current source to disk.
  323.  
  324.  
  325. WB      =    Write binairy file
  326.  
  327. Syntax:        WB         {filename}
  328.         Beg>            [Beg adress]
  329.         End>            [End adress]
  330. Discription:    This will write a binairy image file to disk starting at [Beg
  331.         adress] to [End adress].
  332.  
  333. WL      =    Write link file
  334.  
  335. Syntax:        WL {filename}
  336. Discription:    This will write a link file from your assembled source for
  337.         later use in linking with other assmblers / compilers code.
  338.  
  339.  
  340. WO      =    Write object
  341.  
  342. Syntax:        WO {filename}
  343. Discription:    This will write a executable file from your assembled source.
  344.  
  345.  
  346. WP      =    Write prefs to S:
  347.  
  348. Syntax:        WP
  349. Discription:    This will write your current preferences (found in the project
  350.         menu) to S:ASMONE.PREFS
  351.  
  352.  
  353. WS      =    Write sector(s)
  354.  
  355. Syntax:         WS         {number}
  356.           RAM PTR>    [adress]
  357.         DISK PTR>       [disk offset]
  358.         LENGTH>         [number of sectors]
  359. Discription:    This will write sectors to disk {number} from [adress] starting
  360.         at [disk offset] and write [number of tracks]
  361.  
  362.  
  363. WT    =    Write tracks
  364.  
  365. Syntax:         WT        {number}
  366.           RAM PTR>    [adress]
  367.         DISK PTR>       [disk offset]
  368.         LENGTH>         [number of tracks]
  369. Discription:    This will write tracks to disk {number} from [adress] starting
  370.         at [disk offset] and writing [number of tracks]
  371.         P.S. These are TRACKS and not CYLINDERS !!!!!!!
  372.  
  373.  
  374. X    =    Show register status
  375.  
  376. Syntax:        X
  377. Discription:    This will show the current contents of the registers, PC and
  378.         Stack pointer
  379.  
  380.  
  381. ZB    =    Zap breakpoints
  382.  
  383. Syntax:        ZB
  384. Discription:    This will erase all current breakpoints.
  385.  
  386.  
  387. ZI    =    Zap incmem
  388.  
  389. Syntax:        ZI
  390. Discription:    This will free all allocated memory used for included files.
  391.  
  392.  
  393. ZF    =    Zap file
  394.  
  395. Syntax:        ZF         {filename}
  396. Discription:    This will enable u to delete a file without leaving asmone.
  397.  
  398.  
  399. ZL    =    Zap line
  400.  
  401. Syntax:        ZL        {number}
  402. Discription:    This will delete a {number} of lines of your source starting at
  403.         the current source line.
  404.  
  405.  
  406. ZS    =    Zap source
  407.  
  408. Syntax:        Zap current source
  409. Discription:    This will erase your current source.
  410.  
  411.  
  412.  
  413. @ID    -]
  414. @IH      ]      These are the same as the commands without the @ except for
  415. @IN      ]      the screen modus. With the @ it will be a half screen modus.
  416. @D       ]
  417. @A       ]
  418. @H       ]
  419. @N      -]
  420.  
  421. =M    =    Add workspace
  422.  
  423. Syntax:        =M
  424.         ADD-WORKSPACE (Max.?) KB>
  425. Discription:    This will add some memory to the current workspace.
  426.  
  427.  
  428. =S    =    Show symbols
  429.  
  430. Syntax:        =S
  431. Discription:    This will show all symbols and labels used in your source.
  432.  
  433.  
  434. !    =    Exit asmone
  435.  
  436. Syntax:        !{4 chars}
  437. Discription:    This will enable u to leave asmone if no chars are given. If any
  438.         char is given it will be the extension of your source file
  439.         P.S. extension only works if the menu item is enabled !!
  440.  
  441.  
  442. >    =    Set output to
  443.  
  444. Syntax:        > {filename}
  445. Discription:    This will redirect output to the {filename}. If PRT: is given
  446.         for the {filename} output will be send to the printer.
  447.  
  448.  
  449. ?    =    Calculate
  450.  
  451. Syntax:        ? {formula}
  452. Discription:    This will calculate the formula given. The answer will be in
  453.         Binariry, Hexadecimal and Decimal.
  454.         P.S. Use the ( and ) for paranthese !!!
  455.  
  456.  
  457.  
  458. Have fun !!!!!
  459.  
  460.  
  461. Signed:        Price & KILLogic
  462.  
  463.